home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 3 / BBS in a box - Trilogy III.iso / Files / Tele / Pete Johnson / Condor 1.0 Folder / About Condor… < prev    next >
Encoding:
Text File  |  1991-08-05  |  6.8 KB  |  147 lines  |  [TEXT/QED1]
  1.  
  2.                            About Condor…
  3.  
  4. Condor is a Tabby NetMail-compatible utility to regulate download quotas
  5. per month for a Second Sight BBS. To do so, it counts downloads each night,
  6. and if they exceed a pre-set level it sets or clears a user restriction
  7. flag defined by the sysop. Another sysop-defined user flag grants selected
  8. users immunity to the quota.
  9.  
  10. Once a month, on a day determined by the sysop, Condor clears all download
  11. restriction flags and starts over.
  12.  
  13. Since Condor operates on a month to month basis, everyone is “born again” on the magic day. There is no accumulation of guilt or impossible upload quotas.
  14.  
  15. To use Condor, choose your figure -- I let users download 25 files per
  16. month -- then install a flag-sensitive menu command leading to your files
  17. and put Condor in your nightly chain of events.
  18.  
  19. ------------------------------------------------------------------------
  20.  
  21.                             Basic Setup
  22.  
  23. Copy Condor to the same level as TabbyNet. Open Condor while holding down
  24. the mouse button to configure it. Supply the following items of
  25. information:
  26.  
  27. • Default launch. This is normally the name of your BBS program. It is used
  28. only when Condor can’t find a valid entry in the launch.next file. A “Find”
  29. button allows you to select the application from a file dialog.
  30.  
  31. • Day of Month. This is the day on which you want Condor to reset all
  32. download figures. I allow you to configure it so you can run it off
  33. schedule as necessary in case your board was down on the magic day.
  34.  
  35. • Log Location. This is where Condor stores its data file. A “Find” button
  36. allows you to select the location from a file dialog. This file is normally
  37. called “DL List” (if you want to rename it for some reason, you can do so
  38. by altering STR  507 with ResEdit).
  39.  
  40. • No DLs. This is the flag which Condor sets to notify your menu that a
  41. user has exceeded the download limit. It must be a number between 1 and 24.
  42. You can choose to have Condor set or clear this flag on the basis of
  43. download totals.
  44.  
  45. • Immune. This flag grants the user immunity to processing by Condor. It
  46. must be a number between 1 and 24 and can be either set or cleared to
  47. indicate its status.
  48.  
  49. • Max DLs. This is the maximum downloads allowed non-immune users per
  50. month.
  51.  
  52. • Victim Log. If this is enabled, Condor keeps a log of users who hit the
  53. “magic number.” This log, normally called “Victims Log”  (if you want to
  54. rename it for some reason, you can do so by altering STR  508 with ResEdit)
  55. is kept in the Log Location.
  56.  
  57. • Upload Credit. If you want to credit this month’s uploads against the Max
  58. DLs figure, enter a number here. For instance, if you enter 5, a user with
  59. two uploads would not be flagged until s/he hit the Max DLs + 10 figure.
  60. Enter a zero if you don’t want to credit uploads.
  61.  
  62. • Msg Credit. Works just like Upload Credit, but based on this month’s
  63. public messages.
  64.  
  65. Once you have configured Condor, edit the RRH/SS menu leading to your file
  66. section and install two commands with the same command letter and access
  67. level setting. Define the first so it is used if the user’s flag matches
  68. the NoDLs flag setting. In my case, I used a Command 14 to display a text
  69. file notifying the user that he or she has exceeded the monthly quota.
  70. Define the second command so that it is used if the user’s flag doesn’t
  71. match the NoDLs flag setting, and use it to branch to your file menu.
  72.  
  73. (Note: unless you’re doing something fancy, I don’t recommend that you try
  74. to use the Immune flag to alter menu behavior. The Immune flag is used just
  75. to notify Condor not to alter the NoDLs flag for a given user. It’s easiest
  76. to use the NoDLs flag as the menu toggle.)
  77.  
  78. ------------------------------------------------------------------------
  79.  
  80.                             How Condor Works
  81.  
  82. Every night, Condor reads the UserLog. For each user who has downloaded one
  83. or more files, it compares that user’s download total against a “snapshot”
  84. of the UserLog taken on the “magic day” you’ve specified. If the difference
  85. exceeds Max DLs, it sets or clears (depending on configuration) the No DLs
  86. flag for that user unless the user has the correct Immune flag, in which
  87. case no change is made. In calculating the net download total, Condor
  88. applies credits as applicable for uploads or public messages.
  89.  
  90. Once a month, on the Day of Month you set, Condor takes a new snapshot of
  91. the UserLog and toggles all No DLs flag to “off.” Then Condor sorts its
  92. snapshot data file (this sort enables Condor to more quickly work with the
  93. log during subsequent sessions). This data file consists of the names of
  94. all users with one or more downloads, along with their download, upload and
  95. public message totals.
  96.  
  97. ------------------------------------------------------------------------
  98.  
  99.         Here is the “Over Limit” text file I use:
  100.  
  101. You have exceeded your download quota of 25 files this month.
  102.  
  103. The Glassell Park BBS enforces download quotas to give everyone fair access
  104. to the file sections. Please feel free to explore other features of the BBS
  105. while you wait for the file sections to reopen.
  106.  
  107. Downloads are reset automatically on the first of each month.
  108.  
  109. ------------------------------------------------------------------------
  110.  
  111.                             Wrinkles and Notes
  112.  
  113. If you set a 25-file maximum and someone calls with 24 downloads, this
  114. setup will cheerfully let the person into the downloads section. Also,
  115. since Condor is set to work only at night, a user can sometimes exceed
  116. Condor’s limits with a couple of calls during the day. You can control the
  117. damage by limiting repeat callers with the SS/RRH Config file. But even in
  118. the worst case, you’ll only get beat up for one day of the month.
  119.  
  120. Condor has no limitations in terms of how many users it can process, but if
  121. you are running under MultiFinder or System 7 and you have a lot of users --
  122. 1,000 or more -- you should probably increase Condor’s memory requirement.
  123. It’s set for 200K as shipped.
  124.  
  125. Condor’s data is a readable text file in the following format:
  126.  
  127. DAN FISHBURN                          1       0       0
  128. DANIEL KRABONEN                       2       2       1
  129. DAVID LANCE                          12       0       8
  130.  
  131. Lines are sorted alphabetically by first+last name. Columns 32-39 contain
  132. the download total, columns 40-47 contain uploads and columns 48-55 contain
  133. public messages. These totals are current as of the “magic day” and are
  134. used for comparison the rest of the month.
  135.  
  136. Condor is ©1991 by Pete Johnson, with all rights reserved. Condor is a bonus BBS utility supplied with the AMUG “BBS in a Box” CD-ROM. License is granted to registered owners of “BBS in a Box” to use Condor, but it may not further be distributed without my specific written permission. Don’t make it available as a download or send it to a commercial network.
  137.  
  138. -- Pete Johnson
  139.    PETERJ on GEnie
  140.  
  141.    Glassell Park BBS
  142.    (213) 254-4133
  143.    Post Office Box 65074
  144.    Los Angeles, CA 90065
  145.  
  146.    August 5, 1991
  147.